webPlug Small logo
An HTML editor for the Amiga



Using webPlug

Is not the intention of this document to teach you how to create your own HTML pages... You should know HTML to use webPlug. Anyway, learning HTML while using webPlug is easier.
This is why this doc only explains the features of webPlug. You should know the use of every HTML tag.
In a near future, my homepage will include a list of links to web-pages that teach HTML (spanish and english). If you know of one of these pages, please let me know.

General notes before starting.
webPlug's functions
webPlug's menues
Sending documents to browsers (Using BrowserLinks)

Main Index


Some general notes before starting...



Go to top.

webPlug's functions


webPlug's functions are accessible via the functions menu or via the 'Toolbar'. This toolbar contains image buttons that give access to nearly all it's features.
Each button opens a window that contains the gadgets necessary to create a part of the HTML doc.

Here you'll find information about these functions (from left to right, in order):

Trans icon Translation
This function will translate the ASCII chars to its' HTML equivalent. Simply mark a block of text and press 'Translate'. After a while (if the text is large), the text will appear translated.
The window have 2 checkmarks, which select whether to translate '<', '>', and '&' or not. This is usefull if you mark a block of text that contains HTML tags, so the '<>' won't be translated.

Info icon Info / HTML header
This GUI will insert the HTML header information for the document. Simply type the title (that will be translated) and press 'Insert'.
You can set the BaseFont and you can decide if you want the '<BODY> </BODY>' tags to be inserted or not (you can add them late with the Background function).
Is possible to add some information about the author of the document. This information is inserted as comments in the document.

Styles icon Styles window
Nothing to explain here. Just mark a block of text and insert a style.
Supports Drag'n'Drop to the TextEditor.


Format icon Format window
Contains a list of formatting HTML tags. Simply select a tag, an alignment an go ! :-)
Supports Drag'n'Drop to the TextEditor.

Images icon Images window
This window offers a GUI to insert images into your document. When you load a document (or save it), the path is automatically copied into the image filename string gadget.
Pressing 'Show' will cause webPlug to display the image (using Datatypes or an external viewer. See Configuration.)
When specifying a new image, you'll see that webPlug's window gets busy. This is because the program is using Datatypes to know the size of the image and set it in the window. Of course, this will only happen for kickstart v39+; anyway, the size could be manually modified later. Kick 36/37 users will have to do it this way.

Forms icon Forms window
The forms window allows you to create any form in HTML. Is divided in 2 register-pages, Form and Input. 'Forms' contains the data of the
tag. The Input page contains a list of all possible inputs. Double-click any entry to open the config window for the input.
Only a note: The Select Item (Option) window contains an 'Automatic generation' tool. It will generate automatically the number of options you want.
Supports Drag'n'Drop to the TextEditor.

Lists icon List window
Nothing to explain here. Just mark a block of text and insert a list tag. Future versions of webPlug will offer some kind of automatic generation for lists.
Supports Drag'n'Drop to the TextEditor.

Backs icon Background window
Here you can specify all the tags concerning the background of the page. The 'Show' button will make webPlug display the background image you have selected.
If you want to specify a color, just activate it (by selecting the checkmark) and click on the popup-image. The color requester will appear.

Tables icon Tables window
This page contains the GUI to create tables. It features an automatic generation of tables. If you want, a number will be introduced in each cel (-1 if it's a header cell).
The parameters of each automatically generated cell are taken from current settings...
Supports Drag'n'Drop to the TextEditor.

Links icon Links window
Here you can specify an HTML link. Simply type in the 'Link to' field where do you want the link to point to, mark a block and type insert.
CTags Custom Tags/Strings window
webPlug supports user-configurable HTML tags and strings. This function opens a window that includes 2 lists, Custom Tags and Custom Strings.
You can define a new custom tag (Button New) and then edit it. A CTag consists on a comment, the start tag and the end tag. These tags behave exactly as webPlug's internal ones. Of course, you can use Drag'n'Drop to apply them.

This function also includes Custom Strings. A custom string is just a string that you can add to the text, for example, a URL that you use very often. The custom strings can be dragged and dropped on the TextEditor, or on any string-gadget of webPlug.
Icon Frames window
This button opens the Frames window. By now it is very basic, i.e., it doesn't feature a WYS frame editor (planned for v2.x), but it helps when creating framesets.
Icon Plugins window
webPlug's functionality can be expanded using plugins. A plugin is a separated file (a shared library, located in the webplugins directory) which interfaces with webPlug, so it have some degree of control over it. Each plugin can have a window with its' own interface.
To open a plugin, just double click it's name in the list.

Go to top.

Menus

Althoug the toolbar gives you access to all the tags that webPlug handle, a lot more functions are accessible through the program's menu. Here goes an small description of what you'll find:
Go to top.

Sending the doc to a browser...

webPlug is not a WYSIWYG program. This means that you have no inmediate visual result of what you're doing.
To 'solve' somehow this problem, webPlug features the BrowserLinks. A BrowserLink is simply a shared library that teaches it how to communicate to a given WWW-browser via its' ARexx port. This way, you can edit the HTML document, and send it to a browser to test it with a single mouse click.

By now the following browsers are supported:

Setting a BrowserLink...
BrowserLinks teach webPlug how to communicate with a WWW browser. You have to tell webPlug which browser will you use by setting the appropiate BrowserLink. Simply go to the prefs window and specify the full path of the BrowserLink..
You have to set the full path of the browser, too, so webPlug can find it when you want to run it.


Running the selected browser
If you have specified the full path of your browser, you can execute it by selecting the 'Browser/Run browser' menu or by clicking the 1st button (from left to right) in the Browser Window.. Then, webPlug will try to execute it and will wait for the browser's ARexx port.
If for any reason the browser is not loaded, you can cancel the wait by simply clicking 'Cancel' on the load window.
Please note that if the browser is already loaded and you want to use it with webPlug you have to select 'Browser/Run browser' anyway. In this case, webPlug will not load the browser, of course; it will load the BrowserLink only.

Actually sending it...
Simply select the menu 'Send to browser' or click on the 2nd button (from left to right) in the Browser window, if you send it for the first time, and 'Reload document' if it is not the case.
If the browser supports it, and you've set the 'Bring browser to front/back' option in the prefs, the browser's screen will become the frontmost.

Go to top.

As of v1.3+, webPlug can handle any number of documents (memory permitting :) at the same time. You can easily switch from a document to another by simply selecting the desired document in the listview that you can open using the 'Document' button of the editor's window.

webPlug can remember 5 locations in each document. This way, you don't have to search an search for a given position in the document. Just 'Mark' it (using the Edit/Mark) menu and return to this point at any time (by using the Edit/Go to menu).

From v1.2+, webPlug features Drag'n'Drop support for it's listviews. Simply select a tag (from any window) and drop it on the TextEditor. It will be inserted as if you pressed 'Insert' (that's the reason why the 'Insert' buttons can be hidden in this version).

webPlug includes a 'Search' function. It will search (case insensitive) for a given string all over the document. You can even make webPlug select (mark or block :-) the found string, so you can easily add tags to it.
The string you want to find is "translated" (to ISO-chars).

The editor is still simple. Newer versions of webPlug will include more options.



Go to top.